<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="4.3.4">Jekyll</generator><link href="https://chem-bla-ics.linkedchemistry.info/feed/by_tag/identifier.xml" rel="self" type="application/atom+xml" /><link href="https://chem-bla-ics.linkedchemistry.info/" rel="alternate" type="text/html" /><updated>2026-09-26T15:06:31+00:00</updated><id>https://chem-bla-ics.linkedchemistry.info/feed/by_tag/identifier.xml</id><title type="html">chem-bla-ics</title><subtitle>Chemblaics (pronounced chem-bla-ics) is the science that uses open science and computers to solve problems in chemistry, biochemistry and related fields.</subtitle><author><name>Egon Willighagen</name></author><entry><title type="html">Using compact identifiers in project reports</title><link href="https://chem-bla-ics.linkedchemistry.info/2026/03/29/using-compact-identifiers-in-project-reports.html" rel="alternate" type="text/html" title="Using compact identifiers in project reports" /><published>2026-03-29T00:00:00+00:00</published><updated>2026-03-29T00:00:00+00:00</updated><id>https://chem-bla-ics.linkedchemistry.info/2026/03/29/using-compact-identifiers-in-project-reports</id><content type="html" xml:base="https://chem-bla-ics.linkedchemistry.info/2026/03/29/using-compact-identifiers-in-project-reports.html"><![CDATA[<p>This document describes how you can improve the FAIR-ness of your project report by using
compact identifiers. Of course, it can be applied to any other document too, and has been used
in, for example, journal articles and online documentation already.</p>

<p>Compact identifiers find a balance between compactness in writing and being a persistent, unique,
and global identifier. It “is a string constructed by concatenating a namespace prefix, a separating colon,
and a locally unique identifier (LUI)” (doi:<a href="https://doi.org/10.1038/sdata.2018.29">10.1038/sdata.2018.29</a>).
For example, for proteins it can represent the PDB structure <a href="https://bioregistry.io/pdb:2gc4">2gc4</a> as
<em>pdb:2gc4</em>. There is a clear similarity with the SciCrunch <a href="https://rrid.site/">Research Resource Identifiers</a>
(RRIDs) as used by several journals, like
<a href="https://elifesciences.org/inside-elife/ff683ecc/rrids-how-did-we-get-here-and-where-are-we-going">eLife</a>
(doi:<a href="https://doi.org/10.1007/s12021-015-9284-3">10.1007/s12021-015-9284-3</a>).</p>

<p>When the prefixes are defined by community standards, then a compact identifier can be resolved.
There currently are multiple providers of prefix files (doi:<a href="https://doi.org/10.1038/sdata.2018.29">10.1038/sdata.2018.29</a>),
including Identifiers.org (doi:<a href="https://doi.org/10.1093/bioinformatics/btaa864">10.1093/bioinformatics/btaa864</a>)
and Bioregistry (doi:<a href="https://doi.org/10.1038/s41597-022-01807-3">10.1038/s41597-022-01807-3</a>).
The Bioregistry has an overview of more than twenty registries of prefixes and their metadata
(doi:<a href="https://doi.org/10.1038/s41597-022-01807-3">10.1038/s41597-022-01807-3</a>). The metadata commonly
includes information on the URL pattern for each identifier. Often this is more than one pattern, as
there may more several databases with information for the same identifier.</p>

<p>It is the URL pattern in the database that allows services to <em>resolve</em> the compact identifier
into a link to a database. The above registries correspond to three existing <em>resolvers</em> that will take a compact
identifier as part of a resolver URL and redirect to the database with the record matching
that identifier:</p>

<ul>
  <li>Name-to-Thing (N2T): <a href="https://n2t.net/">https://n2t.net/</a></li>
  <li>Identifiers.org: <a href="https://identifiers.org/">https://identifiers.org/</a></li>
  <li>The Bioregistry: <a href="https://bioregistry.io/">https://bioregistry.io/</a></li>
</ul>

<p>Each of these URLs can be extended with a compact identifier. For example, a taxon record
from the NCBI databases or the PDB entry mentioned earlier:</p>

<ul>
  <li><a href="https://bioregistry.io/pdb:2gc4">https://bioregistry.io/pdb:2gc4</a></li>
  <li><a href="https://identifiers.org/col:6MB3T">https://identifiers.org/col:6MB3T</a> (<code class="language-plaintext highlighter-rouge">col</code> is the prefix for the Catalogue of Life)</li>
</ul>

<h2 id="why-use-in-reports">Why use in reports?</h2>

<p>Using persistent identifiers is generally accepted as a good practice that benefits science
and has been part of the ideas of FAIR data (doi:<a href="https://doi.org/10.1038/sdata.2016.18">10.1038/sdata.2016.18</a>)
and of Open Science. Compact
identifiers make it easy to be precise in reports about what things the reports talk about: they
are relatively short but very precise at the same time. also, that has the benefit that they
are much easier to reuse than labels of things and concepts that intrinsically have a certain
level of uncertainty; a database entry has commonly a very specific meaning.</p>

<h2 id="examples-uses">Examples uses</h2>

<p>The use of compact identifiers can be used in two ways. The simplest is to just put the
compact identifier as plain text in the document, possibly in parentheses
(with the compact identifier highlighted here in bold):</p>

<ul>
  <i>This report is only about the experimental data of the human (<b>NCBITaxon:9606</b>) cell lines.</i>
</ul>

<p>Or:</p>

<ul>
  <i>We found that BRCA1 (<b>ensembl:ENSG00000012048</b>) played an important role.</i>
</ul>

<p>Alternatively, you can add a hyperlink with one of the resolvers, for example, Identifiers.org:</p>

<ul>
  <i>We found that BRCA1 (<b><a href="https://identifiers.org/ensembl:ENSG00000012048">ensembl:ENSG00000012048</a></b>) played an important role.</i>
</ul>

<h3 id="compact-identifiers-for-material-identifiers">Compact identifiers for material identifiers</h3>

<p>The European Registry of Materials proposes to use the compact identifier for their
ERM identifiers (doi:<a href="https://doi.org/10.1186/s13321-022-00614-7">10.1186/s13321-022-00614-7</a>):</p>

<ul>
  <i>
    For example, the NanoSolveIT project registered a material with the ERM00000001 identifier.
    The full Uniform Resource Identifier (URI) for this compound is
    https://nanocommons.github.io/identifiers/registry#ERM00000001 which is too long to be used
    in documentation. The corresponding compact identifier <b>erm:ERM00000001</b> is easy to use in written
    material, analogous to the use of Protein Data Bank (PDB) identifiers for proteins in journals.
  </i>
</ul>

<h3 id="compact-identifiers-for-citation-intent-annotations">Compact identifiers for citation intent annotations</h3>

<p>The compact identifier has also been used as the method to include citation intentions in journal
articles (doi:<a href="https://doi.org/10.1186/s13321-020-00448-1">10.1186/s13321-020-00448-1</a>,
compact identifier here highlighted in bold):</p>

<ul>
  <i>
    We take advantage here of the ability to add notes to full form [..] references in bibliographies.
    These are referred to as bibnotes. The content of the note will be strictly formatted: it will use
    the syntax [<b>cito:usesMethodIn</b>] and formatted in bold. That is, the bibnote starts with the
    [ character, followed by one of the CiTO types, and ends with the ] character. If you wish to
    provide more than one annotation, you can repeat this syntax, separated by one or more spaces,
    for example: [<b>cito:usesMethodIn</b>] [<b>cito:citeAsAuthority</b>].
  </i>
</ul>

<p>Note that in this use, the square brackets and bold typeface are used to make them easier to
be recognized. Also, note that this document uses this approach to indicate the intention of
why the cited articles are cited.</p>

<h2 id="conclusion">Conclusion</h2>

<p>This document described what the compact identifier is, how it helps linking to online
databases, and how they can be used in written reports as plain text, optionally
hyperlinked with one of the compact identifier resolvers.</p>

<h3 id="acknowledgments">Acknowledgments</h3>

<p>I thank <a href="https://n2t.net/github:tabbassidaloii">github:tabbassidaloii</a>,
<a href="https://n2t.net/github:cthoyt">github:cthoyt</a>, and
<a href="https://n2t.net/github:larsgw">github:larsgw</a> for their comment on
<a href="https://github.com/egonw/compact-ids-in-reports">this GitHub repo</a>.</p>]]></content><author><name>Egon Willighagen</name></author><category term="identifier" /><category term="semweb" /><category term="cito" /><category term="cito:usesMethodIn,includesQuotationFrom:10.1038/sdata.2018.29" /><category term="cito:obtainsBackgroundFrom:10.1007/s12021-015-9284-3" /><category term="cito:usesMethodIn:10.1093/bioinformatics/btaa864" /><category term="mycito:usesMethodIn:10.1038/S41597-022-01807-3" /><category term="cito:obtainsBackgroundFrom:10.1038/sdata.2016.18" /><category term="mycito:includesQuotationFrom:10.1186/S13321-022-00614-7" /><category term="mycito:includesQuotationFrom:10.1186/S13321-020-00448-1" /><summary type="html"><![CDATA[This document describes how you can improve the FAIR-ness of your project report by using compact identifiers. Of course, it can be applied to any other document too, and has been used in, for example, journal articles and online documentation already.]]></summary></entry></feed>